home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / misc1 / brclk132.zip / README.TXT < prev    next >
Text File  |  1993-04-09  |  11KB  |  338 lines
  1. BarClock(tm) v1.32
  2.  
  3. Copyright 1993 by Patrick Breen - All rights reserved.
  4.  
  5.  
  6.  
  7. Archive Contents:
  8.  
  9.    README.TXT    -  this file
  10.    CHANGES.TXT   -  revision history of BarClock
  11.    BARCLOCK.EXE  -  BarClock executable
  12.    CLOCKDLL.DLL  -  BarClock support DLL
  13.    REGISTER.TXT  -  Registration for BarClock
  14.  
  15.  
  16.  
  17. Description:
  18.  
  19. BarClock (formerly WinClock) is a utility that displays
  20. useful information in the caption bar of the active window.
  21. This approach is somewhat less obtrusive than having the
  22. information in a window which is always on top or that can
  23. be covered by other windows.
  24.  
  25.  
  26.  
  27. System Requirements:
  28.  
  29. BarClock is completely self-contained and is compatable with
  30. both Windows 3.0 and Windows 3.1.  BarClock uses very
  31. little memory (about 12 k) and uses almost 0 system
  32. resources.
  33.  
  34.  
  35.  
  36. Installation:
  37.  
  38. Since you are reading this, I assume that you have unzipped
  39. the BarClock archive.  The rest of the installation is very
  40. easy.  Create a new program manager item for BarClock.  Make
  41. sure CLOCKDLL.DLL is in the working directory or put it in
  42. your Windows directory.  Double-click to start BarClock.  I
  43. prefer to add the program item to the Startup group in
  44. Windows 3.1.  This causes BarClock to launch every time I
  45. start Windows.  Another way to cause BarClock to launch
  46. every time Windows is started is to add the following line
  47. to your win.ini file:
  48.  
  49. load=barclock.exe
  50.  
  51. This works for Windows 3.0 and 3.1.
  52.  
  53.  
  54. Replacing a prior version:
  55.  
  56. If you have been using an older version of this program, it
  57. is very important that you replace the old "clockdll.dll"
  58. with the new "clockdll.dll" (the proper clockdll.dll has the
  59. same date as the BarClock.exe you wish to run).  The different
  60. versions of the .dll are not compatable with one another.
  61.  
  62.  
  63.  
  64. Instructions:
  65.  
  66. Once BarClock is running, information will appear in the
  67. caption bar of the active window.  Initially, BarClock
  68. displays the date on the left of the bar and the time on
  69. the right.  A short click on either the time or the date
  70. will toggle the display of free memory.  Another short
  71. click will display the percentage of free resources
  72. available.  One more click will display the disk space
  73. available on drive C.  Click and hold the mouse button to
  74. display a menu.  The menu commands are as follows:
  75.  
  76. Setup...
  77.     The setup dialog is used to specify how the information
  78.     is displayed.  The large group of radio buttons is used
  79.     to control where each of the items appears.  An item
  80.     can either appear on the left or right of the caption
  81.     bar or it can be toggled into view.  If more than one
  82.     item is specified for the left or right, they are
  83.     combined and displayed together.  If more than one item
  84.     is set to toggled, the first short click displays the
  85.     first toggled item, a click on this item displays the
  86.     next item, etc.  In addition, an item can be turned off
  87.     which prevents it from being displayed at any time.  (If
  88.     all items are turned off or all are set to toggle, the
  89.     time will continue to display so the menu can be
  90.     accessed!)
  91.  
  92.     In addition this dialog is used to set the time format
  93.     and date format.  The clock can be 24-hour and optionally
  94.     display seconds.  The date format can be chosen from the
  95.     set of formats displayed.
  96.  
  97. About...
  98.     Provides the current version number and tells you where
  99.     you can reach me.
  100.  
  101. Exit
  102.     Removes BarClock and quits the application.
  103.  
  104.  
  105.  
  106.  
  107. Advanced Options:
  108.  
  109. I have added the following advanced options (translation -
  110. there is no UI to set them!) to modify the behavior of
  111. BarClock.  All of these options are controlled by adding
  112. (or changing) lines in the BarClock.INI file which can be
  113. found in your Windows directory.  Future versions of
  114. BarClock will add dialogs that can be used to set these
  115. options directly!
  116.  
  117.  
  118. Chimes - (General)
  119.  
  120. BarClock can play a sound on the hour, on the half hour,
  121. on the quarter hour (15 and 45 past) or any combination
  122. of the three.  If you have MMSYSTEM.DLL and an appropriate
  123. sound driver installed, you can specify a .wav file to play.
  124. If you do not have MMSYSTEM.DLL or a sound driver, BarClock
  125. will simply beep.
  126.  
  127. Wave files can be found in a number of places.  In the
  128. future, I hope to distribute a .wav or two with the clock
  129. as the default chimes.  If you have access Borland C++ v3.1,
  130. one of the examples comes with a file called "sounder.wav"
  131. which is the perfect hourly chime!
  132.  
  133. NOTE:  Microsoft has a sound driver available that let's you
  134. play .wav files using the internal speaker - the quality is
  135. not great but it works!  I beleive the file is called
  136. "speak.exe" and should be available in a number of places.
  137. If you can't find it, drop me a line and I'll point you in
  138. the right direction.
  139.  
  140.  
  141. HourChime=
  142.  
  143.     Specifies name of .wav file to play on the hour.  If
  144.     the name is "none" no chime will occur on the hour.
  145.  
  146.  
  147. HalfHourChime=
  148.  
  149.     Specifies name of .wav file to play on the half hour.
  150.     If the name is "none" no chime will occur on the half
  151.     hour.
  152.  
  153.  
  154. QuarterHourChime=
  155.  
  156.     Specifies name of .wav file to play on the quarter
  157.     hour.  If the name is "none" no chime will occur on
  158.     the quarter hour.
  159.  
  160.  
  161. Date0 - Date4=
  162.  
  163.     These are the 5 date formats.  The syntax for the date
  164.     formats is identical to what Windows uses in its control
  165.     panel.  Here is a brief summary of the keywords:
  166.  
  167.         m    - Month (1-12)
  168.         mm    - Month (01-12)
  169.         mmm    - Month (Jan - Dec)
  170.         mmmm    - Month (January - December)
  171.         d    - Day (1-31)
  172.         dd    - Day (01-31)
  173.         ddd    - Day (Mon-Sun)
  174.         dddd - Day (Monday-Sunday)
  175.         yy    - Year (00-99)
  176.         yyyy - Year (1900-2040)
  177.  
  178.     All months and days are stored in a string table.  They
  179.     can be modified with any resource editor.
  180.  
  181.  
  182. Resource=
  183.  
  184.     This specifies the format string for the resource
  185.     display.  The key words are "upct" and "gpct" which
  186.     stand for the percent of the User heap which is
  187.     available and the percent of the GDI heap which is
  188.     available.  These heaps are shared by all applications
  189.     and when they run dry, it is necessary to quit one
  190.     or more applications before work can continue.  The
  191.     minimum of the two values is often refered to as
  192.     "System Resources" and is the value that can be found
  193.     in the Progam Manager's About dialog.
  194.  
  195.  
  196. DiskSpace=
  197.  
  198.     This specifies the format string for the free disk
  199.     space.  The key words are "drive" which expands to the
  200.     drive letter and "fdisk" which expands to the amount
  201.     of free space on that drive.
  202.  
  203.  
  204. Memory=
  205.  
  206.     This specifies the format string for the free memory.
  207.     The key word "fmem" expands to the amount of free
  208.     memory that is currently available.  This amount
  209.     includes virtual memory.
  210.  
  211.  
  212. ShowWindow=
  213.  
  214.     This determines whether the BarClock window appears
  215.     if the clock cannot find a home.  By default, the window
  216.     does appear and this value is set to 1.  To keep the
  217.     window from appearing, change this value to a 0.
  218.  
  219.  
  220. SystemColors=
  221.  
  222.     This determines whether BarClock uses the system colors
  223.     to draw the text or a custom color that from this .INI
  224.     file.  By default, BarClock uses the system colors and
  225.     this value  is set to 1.  To specify a custom text color,
  226.     change this value to a 0 and specify the color by adding
  227.     the following lines to the .INI file:
  228.  
  229.     TextColorR=(red component of text color)
  230.     TextColorG=(green component of text color)
  231.     TextColorB=(blue component of text color)
  232.  
  233.  
  234. SystemBackground=
  235.  
  236.     This determines whether BarClock uses the system
  237.     background color underneath a custom text color.  This
  238.     option is only meaningful if SystemColors is set to 0.
  239.     By default, this value is set to 1 which causes the clock
  240.     to be drawn on top of the appropriate caption color.  To
  241.     specify a custom background color, set SystemColors to 0
  242.     (and specify a text color - see above), change this value
  243.     to a 0 and specify the color by adding the following
  244.     lines to the .INI file:
  245.  
  246.     BackColorR=(red component of background color)
  247.     BackColorG=(green component of background color)
  248.     BackColorB=(blue component of background color)
  249.  
  250.  
  251. EraseAlways=
  252.  
  253.     This determines whether BarClock invalidates the desktop
  254.     window to remove "ghost" clocks in Windows 3.0.  For
  255.     machines that are running Windows 3.0, this option will
  256.     eliminate the redraw that occurs when switching between
  257.     applications.  By default, BarClock does invalidate and
  258.     this value is set to 1.  This option has no effect if
  259.     you are using Windows 3.1.
  260.  
  261.  
  262. LeftOffset=
  263. RightOffset=
  264.  
  265.     These two values specify how much room BarClock should
  266.     leave between the string it draws and the standard
  267.     system controls.  These can be useful if you are using
  268.     other utilities that want to put controls in the title
  269.     bar.  By default, both values are set to 0.
  270.  
  271.  
  272. UseKB=
  273.  
  274.     If this option is a 1, the free memory and disk space
  275.     are always displayed in kilobytes.  If this option is
  276.     0 (the default), the free memory and disk space scale
  277.     to the best display value.
  278.  
  279.  
  280. Overlap=
  281.  
  282.     If this option is a 1, the text can overlap the window
  283.     title text.  If this option is 0 (the default), the
  284.     text is not displayed if there is not enough room.
  285.  
  286.  
  287. MenuDoubleClick=
  288.  
  289.     This option controls whether the menu is access by a
  290.     click and hold or by a double click.  The default value
  291.     is a 0 and the menu is accessed by click and hold.  In
  292.     order to use the area that the clock information is
  293.     displayed to postion a window, set this value to a 1.
  294.     This will cause a short single click to toggle the
  295.     information and a longer click to behave normally (drag
  296.     the window).  The clock menu can be accessed by a double
  297.     click on the clock information.
  298.  
  299.  
  300.  
  301. Shareware:
  302.  
  303. Feel free to distribute this program to others.  All I
  304. ask is that this file remain with the distributed copies.
  305. This product is shareware.  If you like it, send $5.  If
  306. you want to licence a number of copies, the following table
  307. gives the discount rates:
  308.  
  309. Number of users    Cost        Price per user
  310.   25                $ 100    $4.00
  311.   50                $ 150    $3.00
  312.  100                $ 250    $2.50
  313.  250                $ 500    $2.00
  314.  500                $ 750    $1.50
  315. 1000                $1000    $1.00
  316.  
  317.  
  318.  
  319. Disclaimer:
  320.  
  321. This software is distributed "as is".  Although I know of
  322. no problems with the software, I make no warranties.
  323.  
  324.  
  325.  
  326. Other:
  327.  
  328. If you have any problems with this program or ideas for
  329. features that should be added, I can be reached at the
  330. following electronic addresses (in addition to the mail
  331. address and telephone number below).
  332.  
  333. Internet:    pbreen@world.std.com
  334. CompuServe:  70312,743
  335.  
  336.  
  337. See REGISTER.TXT for the registration form.
  338.